home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / smrtconf.zip / CONFPPE.DOC < prev    next >
Text File  |  1993-05-26  |  10KB  |  192 lines
  1.                   Informative <J>oin a CONFerence PPE
  2.  
  3.                         FOR PCBOARD 15.0
  4.  
  5.             written by Eric Leitner and Paul Waldinger
  6.  
  7.  
  8.         This utility requires PCBoard 15.0 or higher to operate. Written
  9. in Clark Development Company's PPL (PCBoard Programing Language) this
  10. utility is designed to be installed one or any of the various CMD.LST
  11. files which you have created in the PCBSetup.  (Consult the Clark
  12. Development Company documentation for further details and instructions
  13. on installing the CMD.LST files).
  14.  
  15. Why write a PPE to replace the <J>oin a conference command?
  16. ===========================================================
  17.  
  18.         Systems which support many conferences and forums have devloped
  19. conference menus for their users which quite frankly overwhelm the new
  20. users when trying to locate a particular topic or subject. Boards with
  21. 1,000-3,000 conferences generate 20-30 pages of scrolling for the user
  22. to review the conference offering.
  23.         CONF.PPE offers a simple solution for the user. They can use
  24. conventional syntax such as "J 1" to join the first conference or "J WP"
  25. to join the WordPerfect Conference as has always been available directly
  26. from PCBoard.  But suppose they were looking for all conferences that
  27. support communications or protocols.  You might have 8 or 12 of them.
  28. Unless your users are able to scroll through all the pages of the CNFN
  29. file, they will miss them.
  30.         Using the conventional "J S" syntax will only display the strings
  31. within the CNAMES file that you have created, but not necessarily reflect
  32. the conference topics or file selections.  When using CONF.PPE, your user
  33. will be able to SCAN your CNFN file as you have written it for the string
  34. which they have entered,  CONF.PPE will open your CNFN file and display
  35. all lines that contain matches to the entry.  Hopeful this will generate
  36. a much more organized display for the user and one which will allow them
  37. to make a more logical selection of conferences that they wish to join.
  38.         CONF.PPE will also display the complete CNFN file if the user
  39. wishes to capture or view the entire conference offering as the PCBoard
  40. <J> command always permits.
  41.         CONF.PPE also offers the user the option to enter the <N>ame or
  42. <N>umber of the conference they wish to join from its menu if they happened
  43. to enter the <J> command without an extension in error.  This eliminates
  44. some of the frustrations of the users from viewing a page of conference
  45. names which they did not wish in the first place.
  46.         Well, now you have all the info on this little PPE program which
  47. we are sure your users will enjoy.  We have been alpha/beta testing the
  48. program on SOM for 2-3 weeks now as of this writing.  It has not failed
  49. nor caused a user to get confused.  Of course, it does not read nor write
  50. to any user files so you can be assured of your USERS file integrity.
  51.         CONF.PPE will write to your node CALLERs log file what strings and
  52. searches the user prompted.  By writing these searches to your logs, you
  53. will be able to capture what conferences and interests your callers have
  54. and just what information they are looking for.  We don't write the results
  55. since you can imagine what would happen on systems running Internet if a
  56. caller did a scan for all your Internet conferences.  You might need just
  57. a megabyte of space for that entry alone!
  58.  
  59. Included files for this PPE program.
  60. ====================================
  61.  
  62.         The only additional file you should be finding in this .ZIP file
  63. is a copy of CONF.CFG.  CONF.CFG defines certain specific parameters to
  64. your system. The file is a "short" file of three lines.
  65.           No additional files are needed at this time.  Any
  66. other files that you find within this archive were placed by various
  67. sysops of various boards, usually ads.  Hopefully, one is a Smartnet
  68. Network system which we support.  If not look for a copy of SMRT????.ZIP
  69. on Salt Air or any large system.
  70.  
  71. File Locations
  72. ==============
  73.  
  74.         Place both CONF.PPE and CONF.CFG in the same directory.  If you
  75. do as I have also done, then you would put them along with other active
  76. PPE files for your system in the same directory.  The path to these
  77. files does not matter provided you define them properly in PCBSetup (as
  78. described below).
  79.  
  80. CONF.CFG
  81. ========
  82.  
  83.         Since no two PCBoard systems are alike, we have to create a specific
  84. configuration file for CONF.PPE.  The file is really quite small, and consists
  85. of three short lines:
  86.  
  87.         1. Number of lines in your header of the CNFN file
  88.         2. Path AND Name of the CNFN file
  89.         3. Number of screens that the user will see to view
  90.                 the entire CNFN file
  91.  
  92.         example:
  93.         8
  94.         M:\GEN\CNFN
  95.         16
  96.  
  97.         Note that the number of screens is "approximate".  This number
  98. will of course vary depending on the page length defined by the user.
  99. But we would assume you would define it based upon "23" lines to the
  100. page.
  101.  
  102. Installing this PPE file on your system.
  103. ========================================
  104.  
  105.         Before continuing, take a few moments to review the installation
  106. of PPE files into the CMD.LST files in the PCBoard documentation.
  107.  
  108.         The name of this PPE file is CONF.PPE.  However, in your CMD.LST
  109. file in the first column for COMMAND enter a "J"; nothing else just a J.
  110. As noted in your PCB doc's this cmd will replace all entries made by your
  111. users to the J command.
  112.         In the security column, give this command the same level you give
  113. to all users to be able to join a conference.  If you do not wish NEWusers
  114. to be able to use this command, issue a level HIGHER than the new user
  115. level to join a conference in the "Security Levels - User Levels" screen
  116. under option "H"; Security Level "C" screen.  Thus registered users or
  117. only users with a security higher or equal to that defined in the CMD.LST
  118. will be able to run the PPE.  Users with a lower security level will
  119. default the established "J" command and security checks of PCBoard.
  120.         Note: CONF.PPE passes all conference join entries back to PCBoard
  121. so if a user attempts to join a closed conference to which they are not
  122. registered, PCBoard will handle all security checks internally.  The PPE
  123. program is not designed to bypass the PCBoard security checks.
  124.         Finally, insert the path to the CONF.PPE files in the path
  125. statement of PCBSetup. Do not rename the file. If you have a reason that
  126. you have to give the file another name, please report this problem to us
  127. in the Smartnet Conference. Save and Exit PCBSetup.
  128.         The PPE file is now installed and ready for your users to enjoy.
  129.  
  130. CNFN file display
  131. =================
  132.  
  133.         Since most of your users will enjoy this PPE for its search command
  134. it should be noted at this point that your CNFN file should be set up in
  135. a logical manner to yield informative results to the user.  Here on SOM
  136. we have it set up so that the first set of columns displays the conference
  137. number; the second set displays the conference name; third set is 45
  138. characters long and contains various KEYwords which reflect subjects of
  139. the conference and finally the last set which is the associated network to
  140. which the conference would belong.
  141.         CONF.PPE will ONLY read a CNFN file and not a graphics or RIPterm
  142. version (should one exist). We support the PCBoard @X color displays which
  143. eliminate the need for ansi and non-ansi versions.
  144.         Sysops who are using the RWCNF program to generate their
  145. conference lists will find this program integrates very neatly replacing
  146. the conference descriptions with keywords for scans.
  147.  
  148. Here is a sample of a few lines from our CNFN file:
  149.  
  150. @X0C│@X0E143 @X0C│@X0EAmiPro       @X0C│@X0EAmi Pro Windows Word Processing             @X0C│@X0E 22 @X0C│@X0ESmartnet@X0C│@X07
  151. @X0C│@X0E 73 @X0C│@X0EANSI-Drawings@X0C│@X0EAnsi graphic video drawings                 @X0C│@X0E    @X0C│@X0ESmartnet@X0C│@X07
  152. @X0C│@X0E 72 @X0C│@X0EApple        @X0C│@X0EApple/MacIntosh SCSI computer               @X0C│@X0E    @X0C│@X0ESmartnet@X0C│@X07
  153. @X0C│@X0E164 @X0C│@X0EASIA         @X0C│@X0ESmartnet Asia Email - Reach the Orient!     @X0C│@X0E    @X0C│@X0ESmartnet@X0C│@X07
  154. @X0C│@X0E 82 @X0C│@X0EAST          @X0C│@X0EAST Users Support                           @X0C│@X0E    @X0C│@X0ESmartnet@X0C│@X07
  155. @X0C│@X0E111 @X0C│@X0EAstronomy    @X0C│@X0EAstronomy star gazer science                @X0C│@X0E    @X0C│@X0ESmartnet@X0C│@X07
  156. @X0C│@X0E 54 @X0C│@X0EAT&T         @X0C│@X0EA.T. & T. Unix 6300                         @X0C│@X0E    @X0C│@X0ESmartnet@X0C│@X07
  157. @X0C│@X0E 57 @X0C│@X0EAuto-Fix     @X0C│@X0ENeed help with your Car?  Here's the forum! @X0C│@X0E    @X0C│@X0ESmartnet@X0C│@X07
  158. @X0C│@X0E177 @X0C│@X0EAviation     @X0C│@X0EAirplane radio scanner travel               @X0C│@X0E    @X0C│@X0ESmartnet@X0C│@X07
  159.  
  160. BETA code
  161. =========
  162.  
  163.         While PCBoard 15.0 is still under its beta cycle, this code is
  164. also considered to be beta.  We have some further developments for this
  165. PPE which we would like to develope.  However, due to the restraints of
  166. the PPLC compiler at this time, we are not able to implement them.  We
  167. have contacted CDC regarding these specific problems and they have
  168. already been made aware of them. As new versions become available they
  169. will be made available to download on SOM and the Florida Byte Exchange.
  170. Check with us for any specific problems or modifications that you need
  171. to this file and program.
  172.  
  173. File Distribution
  174. =================
  175.  
  176.         We provide this PPE for all systems to display to their users.
  177. Smartnet sysops are invited to call SOM (the host of Smartnet) or the
  178. Florida Byte Exchange any of the Smartnet hubs to obtain the latest
  179. copies of this file.
  180.         Sysops that are interested in learning more about the Smartnet
  181. Network are invited to call ANY of the hubs listed in the Smartnet Node
  182. List  Applications are readily available and there is no fee for
  183. carrying this network.
  184.  
  185.  
  186.     Eric Leitner                             Paul Waldinger
  187. Smartnet So. Florida Host             Smartnet International Host
  188. The Florida Byte Exchange               SOM Premium Info Network
  189.    (305) 972-1901                          (516) 536-8723
  190.  
  191. eof
  192.